1/83 ADD ISSUE 1 GRAPHICS GUIDE 


2. OVERVIEW 


A. Part Introduction 


Graphic facilities on the UNIX operating system are a collection of numerical and graphical commands that 
are used to construct and edit numerical data plots and hierarchy charts. 


Graphical commands fall into one of the four following groups: 

e Statistical Network — Commands that manipulate and plot numerical data 

e Graphical Editor — An editor for graphical displays 

e Table of Contents Routines — Commands that generate graphical tables of contents 

e Graphic Utilities — A collection of graphical utility commands. 
The Statistical Network command, stat(1G), and Graphics Editor commands, ged(1G), are described in this 
portion as well as in the UNIX System User’s Guide. Table of Contents Routines, toe(1G), and Graphic Utilities, 
gutil(1G), are described in the UNIX System User’s Manual. 


B. Usage 


Access 
Graphic facilities are accessed via the graphics(1) command. This command creates a subshell to handle 
requests for graphic commands. The prompt of this shell is the - symbol. The only difference between the UNIX 


operating system standard shell and the graphics shell is the prompt and access to graphic commands. The stan- 
dard shell does not provide direct access to graphic commands. 


The command whatis can be used to generate on-line information about graphic commands. The format 
of the whatis command is: 


whatis option name name ... 
When whatis is invoked without arguments, a list of available graphic commands is printed. When whatis 
is invoked with one or more names (of graphic commands), a brief description of each named command is print- 
ed. The whatis option is -o, which causes whatis to print only options associated with each named command. 
The format for the graphics commands is: 
command [options] [files] 
where: 


e command is the name of a graphics command. 


e the options argument is zero or more letters, each followed by a value. The first option is preceded by 
a — (minus sign). 


e the files argument is zero or more files that contain data from which a graph should be generated. 


The graphics commands will produce the best results when used with a display terminal such as the 
Tektronix display terminal. The tplot(1G) filters can be used in conjunction with the gtop utility command 
to produce drawings on Versatec* and Dasi-type printers. 


*Trademark of Versatec Corporation 
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The EOT command (which is CONTROL d on most terminals) is typed to exit graphies and return to 
the standard shell. The quit command is used to log off the UNIX operating system from graphics. 
Approach 

The basic approach taken in graphies is to generate a drawing by describing it instead of drafting it. Based 
on the information provided, the graphics commands draft the drawing. Any drawing is seen as having two 
fundamental attributes — its underlying logic and its visual layout. For example, attributes of a drawing that 
consist of a plot of the function y = x2 for x between 0 and 10 are: 


e The logic is the equation. 


e The layout consists of an x-y grid, axes labeled perhaps 0 to 10 and 0 to 100, and lines drawn connecting 
the x-y pairs 0,0 to 1,1 to 2,4 ete. 


The way to generate a picture in graphics is: 
gather data| transform data| generate layout | display layout 
Commands to generate the plot: 
y = x40 <=x <=10 
and display this plot on a Tektronix display terminal walla be: 
gas —s0,t10| af " x*2" | plot| td 
where: 
e the gas command generates sequences of numbers, in this case starting at 0 and terminating at 10. 
e the af argument performs general arithmetic transformations. 
e the plot argument builds x-y plots. 
e the td argument displays drawings on Tektronix terminals. 
The resulting drawing is shown in Fig. 2.1. 

Layouts generated by a graphics program may not always be precisely what is wanted. There are two ways 
to influence the layout. Each drawing program accepts options to direct certain layout features. For instance, 
in the previous example, it may be desired to have the x-axis labels indicate each of the numbers plotted and 
not have any y-axis labels at all. To achieve this, the plot command would be changed to: 

plot —xil,ya 
producing the drawing of Fig. 2.2. 

Output from any drawing command can also be affected by editing it directly at a display terminal using 
the graphical editor, ged(1G). To edit a drawing really means to edit the computer representation of the draw- 
ing. In the case of graphics, the representation is called a graphical primitive string (GPS). All drawing com- 


mands (e.g., plot) write GPS, and all device filters (e.g., td) read GPS. The ged program allows manipulation 
of GPS at a display terminal by interacting with the drawing GPS describes. 
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Fig. 2.2—Plot of [gas —s0,t10| af x2| plot —xil,ya| td] Command 
The GPS describes graphical objects drawn within a Cartesian plane 65,534 units on each axis. The plane, 
known as the universe, is partitioned into 25 equal-sized square regions. Multidrawing displays can be produced 


by placing drawings into adjacent regions and then displaying each region. 


Since GPS can be stored in a file, it can be created from any terminal for later displaying on a graphical 
device. 


Numerical Manipulation and Plotting 


& The statistical network, stat(1G), is a collection of numerical commands that operate on vectors. A vector 
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is a text file that contains numbers separated by delimiters, where a delimiter is anything that is not a number. 
For example: 


12345 
arf tty47 Mar 5 09:52 


are both vectors. The latter is the vector: 
475 9 52. 


The following is an easy way to make a Celsius-Fahrenheit conversion table using gas to generate the vector 
of Celsius values: 


gas —s0,t100,i10| af "C,9/5*C+32" 
where: 


e gas —s0,t100,110 is the gas command. It generates a sequence that starts at 0, terminates at 100, and 
increments 10 between successive elements. 


e af" C,9/5*C+382" isthe af command. It interprets Cas the standard input (since no file name is speci- 
fied). The output is a vector with odd elements coming from the standard input and even elements being 
a function of the preceding odd element. 


The output is: 


0.0 32 
10 50 
20 68 
30 86 
40 104 
50 122 
60 140 
70 158 
80 176 
90 194 

100 212 


The following is an example that illustrates the use of vector titles and multiline plots: 


gas| title -v" first ten integers" >N 
root N >RN 

root —r3 N >R38N 

root —rl.5 N >R15N 

plot -FN,g N R1.5N RN R8N | td 


where: 


e title —v "string" is the title command. It associates a string with a vector. In this case, " first ten 
integers" is associated with the vector output by gas. The vector is stored in file N. 


e root —rnis the root command. It outputs the nth root of each element on the input. If —rnis not giv- 
en, the square root is output. Also, if the input is a titled vector, the title will be transformed to reflect 
the root function. 
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e plot —FX,g Y(s)is the plot command. It generates a multiline plot with Y(s) plotted versus X. The g 
option causes tick marks to appear instead of grid lines. 
The resulting plot is shown in Fig. 2.3. 
The next example generates a histogram of random numbers: 
rand —n100| title -v "100 random numbers" | qsort| bucket | hist | td 
where: 


e rand—n100 outputs random numbers using rand(3C). In this case, 100 numbers are output in the range 
0 to 1. 


e qsort sorts the elements of a vector in ascending order. 

e bucket breaks the range of a vector into intervals and counts how many elements from the vector fall 
into each interval. The output is a vector with odd elements being the interval boundaries and even ele- 
ments being the counts. 


e hist builds a histogram based on interval boundaries and counts. 


The output is shown in Fig. 2.4. 
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Fig. 2.3—Illustrating Use of Vector Titles and Multiline Plots 
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100 RANDOM NUMBERS 


Fig. 2.4—Histogram of 100 Random Numbers 


Drawings Built From Boxes 


There is a large class of drawings composed from boxes and text. Examples are structure charts, configura- 
tion drawings, and flow diagrams. In graphics the general procedure to construct such box drawings is the 
same as that for numerical plotting. Namely gather and transform data, build, and display the layout. As an 
example for hierarchy charts the command line: 


dtoc | vtoc | td 
outputs drawings representing directory structures. 


The dtoc(1G) command outputs a table of contents that describes a directory structure (Fig. 2.5). Fields 
from left to right are level number, directory name, and the number of ordinary readable files contained in the 
directory. The vtoc(1G) command reads a (textual) table of contents and outputs a visual table of contents or 
hierarchy chart (Fig. 2.6). Input to vtoe consists of a sequence of entries, each describing a box to be drawn. 
An entry consists of a level number, an optional style field, a text string to be placed in the box, and a mark 
field to appear above the top right-hand corner of the box. 
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Directory Structure for Graphics 


0. “source” 2 
1% "glib.d" 1 
Tel. "gpl.d" 12 
I2: "pslvd" 14 
2; "gutil.d" 6 
y ie "cvrtopt.d" 7 
ye fa "gtop.d" 8 
Rs "ptog.d" 5 
sf "stat.d" 54 
4, "tek4000.d" 5 
4.1 "ged.d" oF 
4.4. “td” 8 
ae "toc.d" 3 
5.1. "ttoc.d" 3 
Bee "VtOCG¢ 22 
6. "whatis.d" 106 


Fig. 2.5— Output of dtoc Command 
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Fig. 2.6—Output of vtoc Command 
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NOTES 


